<?php
// $Id$

/**
 * UserCase 封装来自 cases 数据表的记录及领域逻辑
 */
class UserCase extends QDB_ActiveRecord_Abstract
{
    /**
     * postfile 虚拟属性
     *
     * @var Helper_Uploader_File
     */
    private $_postfile;

    /**
     * 请求删除
     *
     * @param boolean $delete
     *
     * @return QDB_ActiveRecord_Abstract
     */
    function pendingDelete($delete = true)
    {
        if ($delete)
        {
            $this->is_approbated = false;
            $this->is_pending_delete = true;
        }
        else
        {
            $this->is_pending_delete = false;
        }
        return $this;
    }

    /**
     * 设置 postfile 属性
     */
    function setPostfile($postfile)
    {
        $this->_postfile = $postfile;
    }

    /**
     * 返回 postfile 属性
     *
     * @return Helper_Uploader_File
     */
    function getPostfile()
    {
        return $this->_postfile;
    }

    function getIconSrc()
    {
        return rtrim(Q::ini('appini/cases/img_dir'), '/\\') . "/{$this->icon_filename}";
    }

    function getThumbSrc()
    {
        return rtrim(Q::ini('appini/cases/img_dir'), '/\\') . "/{$this->thumb_filename}";
    }

    /**
     * 添加图片对象
     *
     * @param string $pic_filename
     * @param string $thumb_filename
     * @param string $icon_filename
     *
     * @return UserCasePicture
     */
    function addPicture($pic_filename, $thumb_filename, $icon_filename)
    {
        $pic =  new UserCasePicture(array(
            'pic_filename'   => $pic_filename,
            'thumb_filename' => $thumb_filename,
            'icon_filename'  => $icon_filename,
        ));
        $this->pictures[] = $pic;
        return $pic;
    }

    /**
     * 保存前尝试处理上传的文件
     */
    protected function _before_save()
    {
        if ($this->changed('description') || $this->changed('formatter'))
        {
            $this->description_formatted = Helper_Formatter::format($this->description, $this->formatter);
        }

        if (is_null($this->_postfile))
        {
            // 如果是更新对象，允许不提供 postfile
            if ($this->id()) return;
            throw new QDB_ActiveRecord_ValidateFailedException(
                array('postfile' => 'Property "postfile" type mismatch. expected is "Helper_Upload_File".'),
                $this);
        }

        if (!$this->_postfile->isValid())
        {
            throw new QDB_ActiveRecord_ValidateFailedException(array('postfile' => '"postfile" is invalid.'), $this);
        }

        // 添加屏幕截图
        $dir = rtrim(Q::ini('appini/cases/upload_dir'), '/\\') . DS;
        $date = date('Y-m');
        $dest_dir = $dir . $date;
        Helper_Filesys::mkdirs($dest_dir);
        $md5 = md5($this->site_url . '-' . microtime(true));

        // 生成大图
        $pic_filename =  $md5 . '.jpg';
        $image = Helper_Image::createFromFile($this->_postfile->filepath(), $this->_postfile->extname());
        $w = intval(Q::ini('appini/cases/large_pic_width'));
        $h = intval(Q::ini('appini/cases/large_pic_height'));
        $image->crop($w, $h, array('pos' => 'top'));
        $image->saveAsJpeg($dest_dir . DS . $pic_filename, Q::ini('appini/cases/large_pic_quality'));

        // 生成缩略图
        $thumb_filename = $md5 . '-thumb.jpg';
        $w = intval(Q::ini('appini/cases/thumb_pic_width'));
        $h = intval(Q::ini('appini/cases/thumb_pic_height'));
        $image->crop($w, $h);
        $image->saveAsJpeg($dest_dir . DS . $thumb_filename);

        // 生成图标
        $icon_filename = $md5 . '-icon.gif';
        $image->crop(24, 24);
        $image->resizeCanvas(32, 32);
        $image->saveAsGif($dest_dir . DS . $icon_filename);
        if (!$this->icon_filename)
        {
            $this->icon_filename = "{$date}/{$icon_filename}";
            $this->thumb_filename = "{$date}/{$thumb_filename}";
        }

        // 销毁资源并删除上传文件
        $image->destroy();
        $this->_postfile->unlink();

        // 保存关联的图片对象
        $this->addPicture("{$date}/{$pic_filename}",
                "{$date}/{$thumb_filename}",
                "{$date}/{$icon_filename}");
    }

    /**
     * 返回对象的定义
     *
     * @static
     *
     * @return array
     */
    static function __define()
    {
        return array
        (
            // 指定该 ActiveRecord 要使用的行为插件
            'behaviors' => 'uniqueness',

            // 指定行为插件的配置
            'behaviors_settings' => array
            (
                # '插件名' => array('选项' => 设置),
                'uniqueness' => array(
                    'check_props' => 'site_url',
                    'error_messages' => array(
                        'site_url' => '该网站已经登记过了',
                    ),
                ),
            ),

            // 用什么数据表保存对象
            'table_name' => 'cases',

            // 指定数据表记录字段与对象属性之间的映射关系
            // 没有在此处指定的属性，QeePHP 会自动设置将属性映射为对象的可读写属性
            'props' => array
            (
                // 主键应该是只读，确保领域对象的“不变量”
                'id' => array('readonly' => true),

                // 对象创建时间应该是只读
                'created' => array('readonly' => true),

                // 对象最后更新时间应该是只读
                'updated' => array('readonly' => true),


                /**
                 *  可以在此添加其他属性的设置
                 */
                # 'other_prop' => array('readonly' => true),
                'postfile' => array('setter' => 'setPostfile', 'getter' => 'getPostfile'),
                'icon_src' => array('getter' => 'getIconSrc'),
                'thumb_src' => array('getter' => 'getThumbSrc'),

                /**
                 * 添加对象间的关联
                 */
                # 'other' => array('has_one' => 'Class'),

                'owner' => array('belongs_to' => 'Member', 'source_key' => 'member_id'),
                'pictures' => array('has_many' => 'UserCasePicture', 'target_key' => 'case_id', 'on_find_order' => 'created DESC'),
            ),

            /**
             * 允许使用 mass-assignment 方式赋值的属性
             *
             * 如果指定了 attr_accessible，则忽略 attr_protected 的设置。
             */
            'attr_accessible' => 'title, site_url, summary, description, formatter, postfile',

            /**
             * 拒绝使用 mass-assignment 方式赋值的属性
             */
            'attr_protected' => 'id',

            /**
             * 指定在数据库中创建对象时，哪些属性的值不允许由外部提供
             *
             * 这里指定的属性会在创建记录时被过滤掉，从而让数据库自行填充值。
             */
            'create_reject' => '',

            /**
             * 指定更新数据库中的对象时，哪些属性的值不允许由外部提供
             */
            'update_reject' => '',

            /**
             * 指定在数据库中创建对象时，哪些属性的值由下面指定的内容进行覆盖
             *
             * 如果填充值为 self::AUTOFILL_TIMESTAMP 或 self::AUTOFILL_DATETIME，
             * 则会根据属性的类型来自动填充当前时间（整数或字符串）。
             *
             * 如果填充值为一个数组，则假定为 callback 方法。
             */
            'create_autofill' => array
            (
                # 属性名 => 填充值
                # 'is_locked' => 0,
                'created' => self::AUTOFILL_TIMESTAMP ,
                'updated' => self::AUTOFILL_TIMESTAMP ,
                'rating'          => 0,
                'votes_count'     => 0,
                'clicks_count'    => 0,
                'is_approbated'   => true,
            ),

            /**
             * 指定更新数据库中的对象时，哪些属性的值由下面指定的内容进行覆盖
             *
             * 填充值的指定规则同 create_autofill
             */
            'update_autofill' => array
            (
                'updated' => self::AUTOFILL_TIMESTAMP ,
            ),

            /**
             * 在保存对象时，会按照下面指定的验证规则进行验证。验证失败会抛出异常。
             *
             * 除了在保存时自动验证，还可以通过对象的 ::meta()->validate() 方法对数组数据进行验证。
             *
             * 如果需要添加一个自定义验证，应该写成
             *
             * 'title' => array(
             *        array(array(__CLASS__, 'checkTitle'), '标题不能为空'),
             * )
             *
             * 然后在该类中添加 checkTitle() 方法。函数原型如下：
             *
             * static function checkTitle($title)
             *
             * 该方法返回 true 表示通过验证。
             */
            'validations' => array
            (
                'title' => array(
                    array('not_empty', '案例标题不能为空'),
                    array('max_length', 60, '标题不能超过 60 个字符或 20 个汉字'),
                ),

                'summary' => array(
                    array('not_empty', '案例简介不能为空'),
                    array('max_length', 6000, '案例简介不能超过 6000 个字符或 2000 个汉字'),
                ),

                'description' => array(
                    array('not_empty', '案例描述文字不能为空'),
                    array('max_length', 63000, '案例描述不能超过 63000 个字符或 21000 个汉字'),
                ),

                'site_url' => array
                (
                    array('not_empty', '案例网址不能为空'),
                    array('max_length', 80, '案例网址不能超过 80 个字符'),

                ),
            ),
        );
    }


/* ------------------ 以下是自动生成的代码，不能修改 ------------------ */

    /**
     * 开启一个查询，查找符合条件的对象或对象集合
     *
     * @static
     *
     * @return QDB_Select
     */
    static function find()
    {
        $args = func_get_args();
        return QDB_ActiveRecord_Meta::instance(__CLASS__)->findByArgs($args);
    }

    /**
     * 返回当前 ActiveRecord 类的元数据对象
     *
     * @static
     *
     * @return QDB_ActiveRecord_Meta
     */
    static function meta()
    {
        return QDB_ActiveRecord_Meta::instance(__CLASS__);
    }


/* ------------------ 以上是自动生成的代码，不能修改 ------------------ */

}

